home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_4 / stow / stow.doc < prev   
Text File  |  1994-08-30  |  7KB  |  157 lines
  1. STOW V0.95ß
  2. © August 30, 1994 by Leonard D Atkinson II
  3. Concept: Doc of Doc's House BBS
  4.  
  5. Everything in this archive is copyright 1994 by Leonard D Atkinson II.
  6. I'm only copyrighting this for the sake of proving that I wrote it,
  7. otherwise anything may be done with it.  I release all rights to copying
  8. and selling of any part of this archive.  It may be included in a
  9. shareware-type archive like Aminet or the Fish disks without my permission
  10. and sold for profit.  If it is included, I'd appreciate getting word about
  11. it, but it's not necessary.
  12.  
  13. If you still feel like giving me something, send me some email.  A word of
  14. thanks is actually more interesting than five bucks.  My new address is
  15. lda@netcom.com.
  16.  
  17. New stuff:*********************************************************************
  18.  
  19. --   Totally changed the way disks are assembled.  Perfect disks can now be
  20.      made.  Set waste to be 1K and if there is a disk to be made to that
  21.      precision, it will be found no matter what list of files you give it.
  22.      The main algorithm is checking EVERY combination of files until it gets
  23.      one that is good enough.
  24.  
  25. --   Added blocksize option.  This should probably never be used, but just
  26.      in case: you can set the blocksize of the device being copied to.  As
  27.      far as I know AmigaDOS uses 512 blocks most of the time.
  28.  
  29. --   There is a new switch that tells stow not to copy those last few files
  30.      that don't add up to full disk.
  31.  
  32. --   I figured out how much a file takes up on the disk.  It's more than the
  33.      actual length of the file.  If someone can correct me on this, please do,
  34.      but I'm using the formula: bump file size up to nearest block boundary,
  35.      add an extra block for each 72 blocks.  So a file 963 bytes long actually
  36.      takes two blocks, 1024 bytes, plus and extra block.
  37.  
  38. --   The interface uses ReadArgs from the dos.library, so it looks like an
  39.      Amiga executable.
  40.  
  41. *******************************************************************************
  42.  
  43.  
  44. What does it do?
  45.  
  46. Stow looks at files in a directory and then attempts to copy them to
  47. floppies while wasting as little space as possible.  It will do the
  48. best job possible, but it will only try to meet your lowest expectations.
  49. You can tell it to waste a maximum of 1K, which is two disk blocks, and
  50. you will end up with disk as close to perfect as it gets.
  51.  
  52. This program tries to solve the problem of trying to put lots of files
  53. from your hard disk onto many floppies without wasting any space.  It
  54. can be a very boring, long process if done by hand.  SysOps have to
  55. deal with this all the time.  Well, stow should speed things up.
  56.  
  57. Technically, stow can copy files from any one directory to any number of
  58. volumes on any device.  You can back up a directory onto 440K 5.25" or even
  59. to virtual (fms) floppies.  Stow doesn't care, it just needs a name of
  60. a device.  
  61.  
  62. This is beta release because I'm not confident that I have all the bugs
  63. worked out.  If you have any questions or bug reports, I can be reached
  64. by email or snail mail.
  65.  
  66. lda@netcom.com
  67.  
  68. or 
  69.  
  70. Leon Atkinson
  71. 125 Gilger Avenue
  72. Martinez, CA 94553
  73.  
  74. Usage: stow <input directory> <output directory> {<option>}\n");
  75.  
  76. <input directory>   The directory where the files to be stowed are.
  77.                     Subdirectories are ignored.
  78.  
  79. <output directory>  The device files are to be copied to.
  80.  
  81. Options:
  82. LIST <filename>     Create a list of all the files stowed.  This takes
  83.                     the name of the file to be created or re-written.
  84.                     The files are put down in the order copied, which is
  85.                     also by disk.  If you wish them to be sorted by name,
  86.                     use the SORT command that comes with AmigaDOS.
  87.        
  88. ASSUME [n]          Assume disk size.  Defaults to 899072, a blank FFS.  The
  89.                     optional number denotes the limit, expressed as K,
  90.                     which means the given number will be multiplied by 1024.
  91.                     By default stow detects how much free space is left on
  92.                     each disk automatically.
  93.  
  94. WASTE <n>           Waste a maximum of nK per disk.  After a disk is assembled
  95.                     only this much space (or less) will be free.  Sometimes
  96.                     perfect disks (waste == 1) can't be made.  Try using
  97.                     the script command to preview how many disks are made
  98.                     with a certain waste value.
  99.              
  100. SCRIPT <filename>   Don't actually copy files, just create a script file to
  101.                     be executed later.  This is useful for testing, of course,
  102.                     but also for previewing how well certain parameters will
  103.                     make disks.
  104.  
  105. FORMAT "<options>"  Format each disk before copying files to it.  Inside the
  106.                     required quotes put the options you wish to be passed to
  107.                     the format command.  Example: FORMAT "FFS NOICONS"
  108.  
  109. NAME <name>         Name each disk with this prefix.  This option only applies
  110.                     if the format command is used.  Each disk will be named
  111.                     in the form: NAME_AAA, NAME_AAB, ...
  112.   
  113. VERIFY              Verify each file copied.  This only applies when the
  114.                     script command is off (obviously).
  115.   
  116. QUIET               Don't print anything to the screen.
  117.   
  118. NOSORT              This option probably shouldn't be used, but just in case
  119.                     I left it in.  Normally files are sorted by size before
  120.                     disks are made.  This usually speeds the making of disks.
  121.                     
  122. BLOCKSIZE <n>       Set the blocksize of the output device.  This defaults to
  123.                     512 which is standard for AmigaDOS devices, I think.  Don't
  124.                     change this unless you really know what you are doing.
  125.   
  126. NOCOPYALL           Don't copy files that aren't part of a perfect disk.
  127.                     By default stow copies everything; the last files that
  128.                     don't make a perfect disk are copied over.  
  129.  
  130.  
  131.  
  132. Examples:
  133.  
  134. stow c: df0: LIST ram:files.txt
  135.  
  136. would copy your c: directory to multiple floppies in df0, assumes the disks
  137. are already formatted, and puts a list of the files in a text file on RAM:
  138.  
  139.  
  140. stow sys:fonts df3: LIST ram:files.txt ASSUME 440
  141.  
  142. Assumes the output device (df3:) can only handle 440K.
  143.  
  144.  
  145. stow sys:uploads df0: LIST ram:files.txt SCRIPT ram:my.script ASSUME
  146.  
  147. Instead of copying the files, just make a script that can be run later.
  148.  
  149. stow c: df0: LISTram:file.list SCRIPT ram:my.script ASSUME
  150.      FORMAT "FFS NOICONS" NAME MY_ARCHIVE QUIET WASTE 6
  151.  
  152. Make a script for stowing c:, put a list of file in file.list, format the
  153. disks as you go along, name them MY_ARCHIVE_AAA, MY_ARCHIVE_AAB, etc,
  154. and don't print anything to the screen while doing so. Additionally,
  155. leave no more than 6K of free space on each disk.
  156.  
  157.